-
-
Notifications
You must be signed in to change notification settings - Fork 1.7k
fix(feedback): Update docs on Feedback attachments #16219
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
Conversation
|
The latest updates on your projects. Learn more about Vercel for GitHub.
1 Skipped Deployment
|
| "name": "John Smith" | ||
| } | ||
| } | ||
| {"type":"attachment","length":1234,"filename":"screenshot.png"} |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
I don't have a lot of context here, but it's unclear to me what the 'length' key is referencing here. Will this be something obvious to someone working on a feedback context object? If not, I recommend adding an explainer.
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
The length refers to the payload size of the following segment (e.g., <binary screenshot data>). Since we're (supposed to be) adding this to every envelope item already, I think it's fine not to go into details here (as this is already described in detail in the Envelope docs)
coolguyzone
left a comment
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Left a quick question in a comment, otherwise looks good to me!
**Before** - https://develop.sentry.dev/sdk/telemetry/feedbacks/#attaching-screenshots - https://develop.sentry.dev/sdk/data-model/envelope-items/#user-feedback:~:text=Attaching%20Screenshots%3A **After** (awaiting vercel preview) ## DESCRIBE YOUR PR With this PR in native getsentry/sentry-native#1414 we noticed the docs are outdated, since Feedback can get more than just screenshots attached (see [this event](https://sentry-sdks.sentry.io/issues/feedback/?feedbackSlug=sentry-native%3A7227469676&mailbox=ignored&project=4506178389999616&referrer=feedback_list_page&statsPeriod=14d) for example). I updated the docs to be more generic as to what someone can attach to Feedbacks. ## IS YOUR CHANGE URGENT? Help us prioritize incoming PRs by letting us know when the change needs to go live. - [ ] Urgent deadline (GA date, etc.): <!-- ENTER DATE HERE --> - [ ] Other deadline: <!-- ENTER DATE HERE --> - [x] None: Not urgent, can wait up to 1 week+ ## SLA - Teamwork makes the dream work, so please add a reviewer to your PRs. - Please give the docs team up to 1 week to review your PR unless you've added an urgent due date to it. Thanks in advance for your help! ## PRE-MERGE CHECKLIST *Make sure you've checked the following before merging your changes:* - [ ] Checked Vercel preview for correctness, including links - [ ] PR was reviewed and approved by any necessary SMEs (subject matter experts) - [ ] PR was reviewed and approved by a member of the [Sentry docs team](https://github.com/orgs/getsentry/teams/docs)
Before
After
(awaiting vercel preview)
DESCRIBE YOUR PR
With this PR in native getsentry/sentry-native#1414 we noticed the docs are outdated, since Feedback can get more than just screenshots attached (see this event for example).
I updated the docs to be more generic as to what someone can attach to Feedbacks.
IS YOUR CHANGE URGENT?
Help us prioritize incoming PRs by letting us know when the change needs to go live.
SLA
Thanks in advance for your help!
PRE-MERGE CHECKLIST
Make sure you've checked the following before merging your changes: